home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d10
/
logchk12.arc
/
LOGCHEK.DOC
< prev
next >
Wrap
Text File
|
1991-04-28
|
13KB
|
328 lines
┬─┬── ┌─┬─────┐
│ │ │ │
│ │ ┌┬──┐ ┌┬─── │ │ ┬┬ ┬ ┬┬──┐ ┬┬ ┌─
│ │ ││ │ ││ ┌┐ │ │ │├──┤ │├─ │├─┴┐
┴─┴─────┘ └┴──┘ └┴──┘ └─┴─────┘ ┴┴ ┴ ┴┴──┘ ┴┴ ┴
┬┬ ┬ ┬┐ ┌──┬┐
││ ┌┘ ││ ┌┬─┴┘
└┴─┘ ─┴┴─ o └┴──┘
April 20, 1991
A PCBoard 14.5A CALLER Log Viewing Program
(C) Copyright 1991, Michael S. Nelson
All Rights Reserved
SYSOP - SeaHunt BBS
Burlingame, CA (415)344-4348 *HST*
FidoNet 1:125/20, RBBSNet 8:914/501
LogChek - PCBoard CALLER log viewer Page 2
┌──────────────┐
│ INTRODUCTION │
└──────────────┘
Like most PCBoard sysops, I used to use Vern Beurg's LIST.COM (yes, I
registered it LONG ago <grin>) to view my PCBoard CALLER logs. LIST works
great, but it always starts at the beginning of the log if you don't use a
command line switch. When I come home from work, I want to take a quick look
at what happened on the system during the day, and that information is at the
end of the CALLER log, not the beginning.
I also missed the use of color to highlight particular types of
transactions in the log that was introduced with PCBoard 14.5... but I didn't
want to have to do a local logon to the system in order to use PCBoard to
show me the log with the "13 1" and "13 2" commands. So, I decided to write
LogChek.
LogChek will show you your caller logs in reverse order, like PCBoard
does, and it also highlights different classes of events in different colors.
For instance, all security violations are shown in BRIGHT RED on a BLACK
background, so they are really obvious. When a user opens a DOOR, that line
is shown in BRIGHT GREEN. DOWNLOADS are shown in BRIGHT YELLOW, and UPLOADS
are shown in BRIGHT WHITE. When a brand new caller calls in it will show his
logon in BRIGHT MAGENTA. Other colors are used to emphasise other types of
activity. You'll quickly get the hang of it. All the everyday, mundane
messages are shown in the default LIGHTGREY on BLACK, just as if you executed
the "TYPE CALLER1" command in DOS.
┌──────────────────┐
│ ACKNOWLEDGEMENTS │
└──────────────────┘
Thanks to Fred Clark, David Terry, Cam DeBuck, and the others
responsible for the wonderful program that is PCBoard 14.5A!!
Thanks to Richard Couture and Dean Brunette for help on the code of the
program!
And, thanks to the beta testers:
Bob Jacobson of Higher Powered BBS (408) 737-9447
Tom Swegles of Charisma BBS (415) 349-7402
Peter Wadsworth of Coconino County BBS (415) 861-8290
Michael Dew of CannonFodder BBS (404) 860-0367
.\\ichele Hamilton of Sunshine PCBoard (305) 432-2223
LogChek - PCBoard CALLER log viewer Page 3
┌───────────────────────────────┐
│ PREPARATION AND CONFIGURATION │
└───────────────────────────────┘
Since one of the major reasons for my writing LogChek was to display the
CALLER logs in color, no provisions have been made for those running
monochrome video setups. If you are running monochrome, LogChek probably
won't work well for you.
The command line to run LogChek is:
"LOGCHEK C:\PCB\MAIN\CALLERx"
where C:\PCB\MAIN\CALLERx is the complete Drive:Path\Name of the CALLER
log you want to display.
Since I have not yet implemented the ability for LOGCHEK to read
PCBoard's configuration files to determine what CALLER logs to read, you
might want to run it from a batch file, as I do. I keep LogChek.exe in my
C:\PCB directory, which is in my PATH, so my LC.BAT file looks like this:
@echo off
c:
cd\pcb
logchek c:\pcb\main\caller1
logchek c:\pcb\main\caller2
exit
The reason for the "exit" in the last line is that I run LogChek in a
128k DESQview window, and I want the window to automatically close after I
view the second node's log.
When LogChek first loads, there is a slight delay as it loads your
chosen CALLER file into memory. After that, the file is closed, and all
further processing is done in memory. Note that at the present time, LogChek
will only display the LAST 650 lines of your CALLER log, due to memory
constraints (and my neophyte programmer status <grin>). A future release
will have the ability to read the entire file.
There's a popup HELP screen accessable by typing ALT-H or F1, and you
exit from the program with ESC or ALT-H. To scroll up and and down, use your
and keys. You can PAGE up and down with your PageUp and PageDn keys. Go
to the beginning or the end of the display buffer with your HOME or END keys.
This version has a KEYWORD SEARCH function, too... press ALT-F to use it.
Ctl-L or F3 repeats the last search. Alt-A is the program info screen.
LogChek is written in Borland C++, and compiled with the TCXL v5.52 C
windowing library, so it is DV-Aware, and will write to DESQview's screen
buffer. It also opens your CALLER logs in SHARED, READONLY, DENYNONE mode...
so it is important that you have DOS's SHARE.EXE installed if you are going
to run LogChek under a MultiTasker or a NetWork.
LogChek - PCBoard CALLER log viewer Page 4
┌────────────────┐
│ DESQview SETUP │
└────────────────┘
Change a Program
Program Name............: LogChek
Keys to Use on Open Menu: LC Memory Size (in K): 128
─────────────────────────────────────────────────────────────────────────────
Program...: g:\batch\lc.bat
Parameters:
Directory.: c:\pcb\main
─────────────────────────────────────────────────────────────────────────────
Options:
Writes text directly to screen.......: [Y]
Displays graphics information........: [N]
Virtualize text/graphics (Y,N,T).....: [N]
Uses serial ports (Y,N,1,2)..........: [N]
Requires floppy diskette.............: [N]
---------------------------------------------------------------------------
Change a Program Advanced Options
System Memory (in K).......: 0 Maximum Program Memory Size (in K)..:
Script Buffer Size.......: 1000 Maximum Expanded Memory Size (in K):
Text Pages: 1 Graphics Pages: 0 Initial Mode: Interrupts: 00 to FF
────────────────────────────────────────────────────────────────────────────
Window Position:
Maximum Height: 25 Starting Height: 25 Starting Row...: 0
Maximum Width.: 80 Starting Width.: 80 Starting Column: 0
────────────────────────────────────────────────────────────────────────────
Shared Program
Pathname..:
Data......:
────────────────────────────────────────────────────────────────────────────
Close on exit (Y,N,blank)......: [N] Uses its own colors..............: [Y]
Allow Close Window command.....: [Y] Runs in background (Y,N,blank)...: [ ]
Uses math coprocessor..........: [Y] Keyboard conflict (0-F)..........: [0]
Share CPU when foreground......: [Y] Share EGA when foreground/zoomed.: [Y]
Can be swapped out (Y,N,blank).: [ ] Protection level (0-3)...........: [0]
So, with this setup, and the LC.BAT file shown on the previous page,
just tap your DESQ key, type CV <ENTER>, and you'll be viewing your logs.
LogChek - PCBoard CALLER log viewer Page 5
┌──────────────────────────────────────┐
│ LICENSING AND DISTRIBUTION AGREEMENT │
└──────────────────────────────────────┘
Copyright (C) 1991 by Michael S. Nelson of SeaHunt BBS.
ALL RIGHTS RESERVED. COMMERCIAL DISTRIBUTION AND/OR USE PROHIBITED WITHOUT
WRITTEN PERMISSION FROM MICHAEL S. NELSON OF SEAHUNT BBS.
Non-Commercial distribution and/or use is permitted under the following
terms:
1. You may copy and distribute copies of LogChek executable code as you
receive it, in any medium, provided that you do so in a lawful,
friendly manner.
2. You must keep this License Agreement intact and give any other
recipients of the LogChek program a copy of this License Agreement
along with the program.
3. You must distribute LogChek in unmodified form. You may not add an
advertisement for your Bulletin Board System, User Group, or
anything else as a file in the distribution packet. You may not
add, modify or delete any of the files in the LogChek distribution
archive.
4. LogChek must be distributed for free. You may not charge a
distribution fee for the physical act of transferring a copy of this
program. You may not place this program in any file area of a
Bulletin Board System if a fee is required to download from that
area.
5. LogChek may not be distributed in any way as part of a package that
is part of a sales transaction whether that package be other
software or hardware, such as a modem, CD-ROM, Hard Drive, or any
software collections.
6. You may not modify your copy or copies of LogChek or any portion of
it and you can not copy and distribute any modifications. LogChek
is distributed in ZIP format and it is preferred (but not required)
that you leave it in that format.
LogChek - PCBoard CALLER log viewer Page 6
7. You may not copy, sublicense, distribute or transfer LogChek except
as expressly provided under this License Agreement. Any attempt
otherwise to copy, sublicense, distribute or transfer LogChek is
void and your rights to use the program under this License agreement
shall be automatically terminated.
8. You may not incorporate parts of LogChek into other programs without
the written permission of Michael S. Nelson. Permission may or may
not be granted based upon a determination of your intended use.
9. You may use the software only after understanding and agreeing to
the above terms.
┌─────────────┐
│ NO WARRANTY │
└─────────────┘
LOGCHEK IS LICENSED FREE OF CHARGE AND THERE IS ABSOLUTELY NO WARRANTY.
MICHAEL S. NELSON, SEAHUNT BBS AND ANY OTHER PERSONS THAT MAY BE INVOLVED
IN THE DISTRIBUTION OF LOGCHEK PROVIDE LOGCHEK "AS IS" WITHOUT WARRANTY OF
ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE.
THIS PROGRAM IS GUARANTEED TO DO ABSOLUTELY NOTHING BUT OCCUPY SPACE ON
YOUR DISC. USE IT AT YOUR OWN RISK.
LogChek - PCBoard CALLER log viewer Page 7
┌───────────────────┐
│ TECHNICAL SUPPORT │
└───────────────────┘
Since LogChek is provided free of charge, there is no guarantee of
technical support. However, you may contact me by FIDONET e-mail or RBBSNet
e-mail at the address listed on the cover sheet of this documentation. I
also monitor several PCBoard conferences on Intelec, RIME, SmartNet, and
FidoNet. Last, but not least, you can reach me in the UTILITIES conference
on SaltAir BBS.
If you have any suggestions on how to improve the program, or if you
have any bugs to report, I'd like to hear from you. Please direct any
complaints to /DEV/NULL.
┌─────────────────┐
│ RELEASE HISTORY │
└─────────────────┘
Version 1.00 First PUBLIC release 04-04-91 as "CallView"
Version 1.10 Added additional colorization keywords, exploding viewing
window, HOME and END key functions.
Version 1.20 Cleaned up the user interface, added KEYWORD searching,
now compiled under the new Borland C++ with TCXL 5.52.02
C library. Name changed to LogChek due to a name conflict
with a similar program for WildCat! caller logs
**** END DOCUMENTATION for LogChek ****